MV_CC_FileAccessRead

MV_CC_FileAccessRead

Read files from camera.

API Definition

int MV_CC_FileAccessRead(
  void                *handle,
  MV_CC_FILE_ACCESS   pstFileAccess
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pstFileAccess

[IN] Structure for getting or saving files, see the structure MV_CC_FILE_ACCESS for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

After connecting to the device, you can call this API to read files from the camera and save them to local PC.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices of specific transport protocol in the subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }
    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create handle
    int nDeviceIndex = 0;
    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }
    //Connect to device
    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }
    MV_CC_FILE_ACCESS stMcFileAccess;
    stMcFileAccess.pUserFileName =  "UserSet1.txt";
    stMcFileAccess.pDevFileName =  "UserSet1";
    nRet = MV_CC_FileAccessRead( m_handle, &stMcFileAccess);
    if (MV_OK != nRet)
    {
        printf("error: Reading from camera failed. [%x]\n", nRet);
        return;
    }
    //Other process...

    //Close camera

    nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }
    //Destroy handle and release resources
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}

MV_CC_FileAccessRead

Read files from camera.

API Definition

int MV_CC_FileAccessRead(
  void                *handle,
  MV_CC_FILE_ACCESS   pstFileAccess
);

Parameters

handle

[IN] Device handle, which is returned by MV_CC_CreateHandle or MV_CC_CreateHandleWithoutLog.

pstFileAccess

[IN] Structure for getting or saving files, see the structure MV_CC_FILE_ACCESS for details.

Return Value

Return MV_OK(0) on success, and return Error Code on failure.

Remarks

After connecting to the device, you can call this API to read files from the camera and save them to local PC.

The following sample code is for reference only.

#include "MvCameraControl.h"

void main()
{
    int nRet = -1;
    void* m_handle = NULL;

    //Enumerate all devices of specific transport protocol in the subnet
    unsigned int nTLayerType = MV_GIGE_DEVICE | MV_USB_DEVICE;
    MV_CC_DEVICE_INFO_LIST m_stDevList = {0};
    nRet = MV_CC_EnumDevices(nTLayerType, &m_stDevList);
    if (MV_OK != nRet)
    {
        printf("error: EnumDevices fail [%x]\n", nRet);
        return;
    }
    int i = 0;
    if (m_stDevList.nDeviceNum == 0)
    {
        printf("no camera found!\n");
        return;
    }

    //Select the first found online device and create handle
    int nDeviceIndex = 0;
    MV_CC_DEVICE_INFO m_stDevInfo = {0};
    memcpy(&m_stDevInfo, m_stDevList.pDeviceInfo[nDeviceIndex], sizeof(MV_CC_DEVICE_INFO));
    nRet = MV_CC_CreateHandle(&m_handle, &m_stDevInfo);
    if (MV_OK != nRet)
    {
        printf("error: CreateHandle fail [%x]\n", nRet);
        return;
    }
    //Connect to device
    unsigned int nAccessMode = MV_ACCESS_Exclusive;
    unsigned short nSwitchoverKey = 0;
    nRet = MV_CC_OpenDevice(m_handle, nAccessMode, nSwitchoverKey);
    if (MV_OK != nRet)
    {
        printf("error: OpenDevice fail [%x]\n", nRet);
        return;
    }
    MV_CC_FILE_ACCESS stMcFileAccess;
    stMcFileAccess.pUserFileName =  "UserSet1.txt";
    stMcFileAccess.pDevFileName =  "UserSet1";
    nRet = MV_CC_FileAccessRead( m_handle, &stMcFileAccess);
    if (MV_OK != nRet)
    {
        printf("error: Reading from camera failed. [%x]\n", nRet);
        return;
    }
    //Other process...

    //Close camera

    nRet = MV_CC_CloseDevice(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: CloseDevice fail [%x]\n", nRet);
        return;
    }
    //Destroy handle and release resources
    nRet = MV_CC_DestroyHandle(m_handle);
    if (MV_OK != nRet)
    {
        printf("error: DestroyHandle fail [%x]\n", nRet);
        return;
    }
}